6.5.2 创建法币支付订单

#简要描述：获取现金（法币）支付（充值）订单

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/receive/cash/payment/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	平台分配商户 key
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户 ID	商户平台本地用户 ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情说明在最下方）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
channelCode	string	是	渠道编码	通过文档 6.5.1 接口获取渠道编码（channelCode 字段）
currency	string	是	币种	订单计价币种
amount	number	是	金额	订单计价金额
localUserRealName	string	否	本地用户真实姓名
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "conantest344",
  "localUserId": "conan",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
  "isBlockchain": true,
  "channelCode": "tencentest9",
  "currency": "CNY",
  "amount": "100",
  "localUserRealName": "柯南",
  "sign": "9662c0f104123b0ccac049108f174589"
}

返回值

参数名称	类型	参数含义	参数说明
code	int	请求状态	返回代码，0 为业务成功，否则代表不同的错误
success	boolean	成功状态	成功标识，与 code=0 一致，用于兼容历史
message	string	描述	错误消息。如果有错误时，返回的错误消息
data	json	返回数据。	参数详见下面说明
└ orderId	long	订单 ID
└localOrderId	string	商户平台本地订单号
└luiUrl	string	支付链接地址

返回示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 352950471221317,
    "localOrderId": "conantest344",
    "uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
  }
}

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例

{
  "amount": "100",
  "currency": "CNY",
  "localOrderId": "conantest344",
  "merchantId": 302992856974,
  "merchantUserId": "conan",
  "notifyTime": 1757577957437,
  "orderCreateTime": 1757577574425,
  "orderId": "352950471221317",
  "paidAmount": "100",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "sign": "774720acbacafca99af62b98d72154d3",
  "key": "9yUreYgTRtit39Dy"
}

参数名称	类型	参与签名	参数含义	参数说明
amount	decimal	是	订单金额
currency	string	是	币种
localOrderId	string	是	商户本地订单号
merchantId	string	是	商户 ID
merchantUserId	string	是	商户平台本地用户 ID
notifyTime	long	是	回调时间	毫秒
orderCreateTime	long	是	订单创建时间	毫秒
orderId	string	是	订单号
paidAmount	decimal	是	支付金额
status	string	是	订单状态	SUCCESS:已完成 \| FAIL:已失败
type	string	是	订单类型	PAYMENT 支付、WITHDRAW 提款
sign	string	否	md5 签名	详情看签名算法
key	string	是	商户 key

如果您接受到了回调信息，只需要返回success，即表示消息已处理，本条回调不再会发送，否则会尝试重复发送直到获得期望的响应，目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s，都无响应后，不再重复发送。

请求参数​

请求 json 样例​

返回示例​

回调详情说明​

回调的方式是：POST application/json​

回调参数 json 化示例​

请求参数

请求 json 样例

返回示例

回调详情说明

回调的方式是：POST application/json

回调参数 json 化示例